feat: Add Grafana integration by mfuzailzubari · Pull Request #3040 · superplanehq/superplane

mfuzailzubari · 2026-02-11T14:04:56Z

Implements #1945

This PR implements the Grafana integration with:

Query Data Source action (Grafana Query API via POST /api/ds/query)

Authorization:

Grafana API key/service account token for API calls
Optional Shared Secret for the alert webhook via Authorization: Bearer

Implementation notes:

Query Data Source now sends datasource as { uid: "" } to match Grafana’s Query API.
Grafana alert trigger now creates a unique webhook per trigger node (not a shared integration webhook).
Added unit tests for Query Data Source and On Alert Firing auth handling.

Demo video: https://drive.google.com/file/d/117GAjLWyp2pic79nzOqDvvDm64-qA094/view?usp=sharing

pkg/integrations/grafana/on_alert_firing.go

pkg/integrations/grafana/client.go

AleksandarCole · 2026-02-12T06:37:25Z

@mfuzailzubari thank you for submitting this one!
Can you please resolve the branch conflicts. I will move on to the functional testing in the meantime, one thing I can see from the video is that integration and components do not use Grafana icon, please address that one when you get the chance and I will share more details after functional review.

pkg/core/trigger.go

pkg/integrations/grafana/example_data_on_alert_firing.json

mfuzailzubari · 2026-02-13T06:05:59Z

@mfuzailzubari thank you for submitting this one! Can you please resolve the branch conflicts. I will move on to the functional testing in the meantime, one thing I can see from the video is that integration and components do not use Grafana icon, please address that one when you get the chance and I will share more details after functional review.

Conflits are resolved, moving on to other findings.

pkg/integrations/grafana/example_data_on_alert_firing.json

pkg/core/trigger.go

pkg/integrations/grafana/client.go

pkg/integrations/grafana/example_output_query_data_source.json

mfuzailzubari · 2026-02-13T16:16:59Z

Fixed all the issues raised in the thread.

AleksandarCole · 2026-02-16T11:11:24Z

@mfuzailzubari I have not managed to set this up fully - I tested the query component and it worked, but the trigger one is not good. We need to avoid user having to configure these webhooks manually if there are API endpoints through which we can do this.

web_src/src/pages/workflowv2/mappers/grafana/query_data_source.ts

pkg/integrations/grafana/on_alert_firing.go

mfuzailzubari · 2026-02-17T10:23:31Z

@mfuzailzubari I have not managed to set this up fully - I tested the query component and it worked, but the trigger one is not good. We need to avoid user having to configure these webhooks manually if there are API endpoints through which we can do this.

fixed it. please check.

AleksandarCole · 2026-02-17T12:09:48Z

@mfuzailzubari managed to get it to work.
Before I request any UI, assigning to engineering to evaluate the approach and do a code review.
@forestileao can you take this one?

web_src/src/ui/componentSidebar/index.tsx

web_src/src/pages/workflowv2/mappers/grafana/on_alert_firing.ts

forestileao · 2026-02-17T13:59:33Z

Also, the CI tests should pass

pkg/integrations/grafana/grafana.go

pkg/integrations/grafana/on_alert_firing.go

pkg/server/server.go

pkg/integrations/grafana/webhook_handler.go

Signed-off-by: Muhammad Fuzail Zubari <mfuzail.zubari@gmail.com>

…ent docs (superplanehq#1945) Signed-off-by: Muhammad Fuzail Zubari <mfuzail.zubari@gmail.com>

… UI-editable (superplanehq#1945) Signed-off-by: Muhammad Fuzail Zubari <mfuzail.zubari@gmail.com>

…uperplanehq#1945) Signed-off-by: Muhammad Fuzail Zubari <mfuzail.zubari@gmail.com>

… datasource listing (superplanehq#1945) Signed-off-by: Muhammad Fuzail Zubari <mfuzail.zubari@gmail.com>

…egacy API key fallback) (superplanehq#1945) Signed-off-by: Muhammad Fuzail Zubari <mfuzail.zubari@gmail.com>

… copy button (superplanehq#1945) Signed-off-by: Muhammad Fuzail Zubari <mfuzail.zubari@gmail.com>

Signed-off-by: Muhammad Fuzail Zubari <mfuzail.zubari@gmail.com>

…te firing trigger on top-level status (superplanehq#1945) Signed-off-by: Muhammad Fuzail Zubari <mfuzail.zubari@gmail.com>

…onAlertFiring setup Signed-off-by: Muhammad Fuzail Zubari <mfuzail.zubari@gmail.com>

…lanehq#1945) Signed-off-by: Muhammad Fuzail Zubari <mfuzail.zubari@gmail.com>

This PR bootstraps AWS SNS integration support. Implemented SNS components: - `aws.sns.onTopicMessage` - `aws.sns.getTopic` - `aws.sns.getSubscription` - `aws.sns.createTopic` - `aws.sns.deleteTopic` - `aws.sns.publishMessage` --------- Signed-off-by: Fadhili Juma <ffumwa@gmail.com> Signed-off-by: Lucas Pinheiro <lucas@superplane.com> Co-authored-by: Lucas Pinheiro <lucas@superplane.com> Signed-off-by: Muhammad Fuzail Zubari <mfuzail.zubari@gmail.com> Signed-off-by: Muhammad Fuzail Zubari <mfuzail.zubari@gmail.com> Signed-off-by: Muhammad Fuzail Zubari <mfuzail.zubari@gmail.com>

Three new GitLab components: - `gitlab.getPipeline` - fetch information about a pipeline - `gitlab.getLatestPipeline` - fetch the latest pipeline on a ref - `gitlab.getTestReportSummary` - fetch the test report summary for a pipeline --------- Signed-off-by: Lucas Pinheiro <lucas@superplane.com> Co-authored-by: Cursor Agent <cursoragent@cursor.com> Signed-off-by: Muhammad Fuzail Zubari <mfuzail.zubari@gmail.com> Signed-off-by: Muhammad Fuzail Zubari <mfuzail.zubari@gmail.com> Signed-off-by: Muhammad Fuzail Zubari <mfuzail.zubari@gmail.com>

New components for GItLab: - New gitlab.onPipeline trigger to listen to GitLab pipeline events - New gitlab.runPipeline trigger to run GitLab pipelines --------- Signed-off-by: Lucas Pinheiro <lucas@superplane.com> Co-authored-by: Cursor Agent <cursoragent@cursor.com> Signed-off-by: Muhammad Fuzail Zubari <mfuzail.zubari@gmail.com> Signed-off-by: Muhammad Fuzail Zubari <mfuzail.zubari@gmail.com> Signed-off-by: Muhammad Fuzail Zubari <mfuzail.zubari@gmail.com>

Signed-off-by: Igor Šarčević <igor@operately.com> Signed-off-by: Muhammad Fuzail Zubari <mfuzail.zubari@gmail.com>

…anehq#3116) Signed-off-by: Igor Šarčević <igor@operately.com> Signed-off-by: Muhammad Fuzail Zubari <mfuzail.zubari@gmail.com>

This PR overhauls the SuperPlane CLI command structure to make resource discovery and canvas workflows easier, while also making command implementation more maintainable. Before: ``` superplane <action> <resource> ``` Now ``` superplane <resource> <action> ``` The new structure makes it easier to discover things, build an internal structure to extend the commands and sub-commands going forward, and is also a pattern used in other CLIs - [see gh](https://github.com/cli/cli). ### CLI internals - Refactored CLI internals into a reusable command framework: - Added `pkg/cli/core` with shared command binding/context logic. - Added centralized output rendering with support for `text`, `json`, and `yaml`. - Reorganized CLI commands into resource-focused groups under `pkg/cli/commands/*` ### New discovery-focused commands: - `superplane integrations list --connected` - `superplane integrations list-resources --id <integration-id> --type <resource-type> [--parameters key=value,...]` - `superplane components list --from <integration>` - `superplane triggers list --from <integration>` ### Global output flag You can control the output of the commands now with `--output` flag. Available options are: json / yaml / text. --------- Signed-off-by: Lucas Pinheiro <lucas@superplane.com> Signed-off-by: Muhammad Fuzail Zubari <mfuzail.zubari@gmail.com> Signed-off-by: Muhammad Fuzail Zubari <mfuzail.zubari@gmail.com> Signed-off-by: Muhammad Fuzail Zubari <mfuzail.zubari@gmail.com>

Signed-off-by: Igor Šarčević <igor@operately.com> Signed-off-by: Muhammad Fuzail Zubari <mfuzail.zubari@gmail.com>

…rplanehq#3131) Right now, we have this: ``` superplane integrations list -> list available integrations superplane integrations list --connected -> list connected integrations superplane integrations get <integration-name> -> get details about an available integration ``` The issue here is that we also need commands for managing connected integrations, and having them and the discovery-related commands under the same root is a bit confusing. So, I'm moving all the discovery-related commands to a new index command: ``` superplane index integrations superplane index integrations --name <integration-name> superplane index triggers superplane index triggers --from <integration-name> superplane index triggers --name <trigger-name> superplane index components superplane index components --from <integration-name> superplane index components --name <trigger-name> ``` With that, everything under the index command is about discovery, and finding available integrations, triggers, and components you can use, and `superplane integrations` becomes about managing connected integrations. --------- Signed-off-by: Lucas Pinheiro <lucas@superplane.com> Signed-off-by: Muhammad Fuzail Zubari <mfuzail.zubari@gmail.com> Signed-off-by: Muhammad Fuzail Zubari <mfuzail.zubari@gmail.com> Signed-off-by: Muhammad Fuzail Zubari <mfuzail.zubari@gmail.com>

Signed-off-by: Muhammad Fuzail Zubari <mfuzail.zubari@gmail.com>

…ls consistency (superplanehq#1945) Signed-off-by: Muhammad Fuzail Zubari <mfuzail.zubari@gmail.com>

…shared secret input (superplanehq#1945) Signed-off-by: Muhammad Fuzail Zubari <mfuzail.zubari@gmail.com>

Signed-off-by: Muhammad Fuzail Zubari <mfuzail.zubari@gmail.com>

… UI-editable (superplanehq#1945) Signed-off-by: Muhammad Fuzail Zubari <mfuzail.zubari@gmail.com>

…uperplanehq#1945) Signed-off-by: Muhammad Fuzail Zubari <mfuzail.zubari@gmail.com>

…egacy API key fallback) (superplanehq#1945) Signed-off-by: Muhammad Fuzail Zubari <mfuzail.zubari@gmail.com>

Signed-off-by: Muhammad Fuzail Zubari <mfuzail.zubari@gmail.com>

cursor

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{Bugbot Autofix is OFF. To automatically fix reported issues with Cloud Agents, enable Autofix in the Cursor dashboard.}

cursor · 2026-02-19T11:36:46Z

db/migrations/20260212033945_increase-app-installations-state-description-to-1024.up.sql

@@ -0,0 +1,2 @@
+ALTER TABLE app_installations
+ALTER COLUMN state_description TYPE character varying(1024);


New migrations missing down migration files

Medium Severity

Both new migration files are added without corresponding .down.sql counterparts. Every one of the 50+ existing migrations in the codebase has a paired .down.sql file. Without down migrations, schema changes from these two migrations cannot be rolled back, and any tooling or CI checks that enforce migration symmetry will fail.

Additional Locations (1)

db/migrations/20260216151135_add-service-accounts.up.sql#L1-L27

AleksandarCole added pr:stage-1/3 Needs to pass basic review. wfh labels Feb 11, 2026

cursor bot reviewed Feb 11, 2026

View reviewed changes

pkg/integrations/grafana/on_alert_firing.go Outdated Show resolved Hide resolved

pkg/integrations/grafana/client.go Show resolved Hide resolved

AleksandarCole added pr:stage-2/3 Needs to pass functional review and removed pr:stage-1/3 Needs to pass basic review. labels Feb 12, 2026

forestileao reviewed Feb 12, 2026

View reviewed changes

pkg/core/trigger.go Outdated Show resolved Hide resolved

forestileao reviewed Feb 12, 2026

View reviewed changes

pkg/integrations/grafana/example_data_on_alert_firing.json Show resolved Hide resolved

cursor bot reviewed Feb 13, 2026

View reviewed changes

pkg/integrations/grafana/example_data_on_alert_firing.json Show resolved Hide resolved

cursor bot reviewed Feb 13, 2026

View reviewed changes

pkg/core/trigger.go Outdated Show resolved Hide resolved

cursor bot reviewed Feb 13, 2026

View reviewed changes

pkg/integrations/grafana/client.go Show resolved Hide resolved

cursor bot reviewed Feb 13, 2026

View reviewed changes

pkg/integrations/grafana/client.go Show resolved Hide resolved

cursor bot reviewed Feb 13, 2026

View reviewed changes

pkg/integrations/grafana/example_output_query_data_source.json Show resolved Hide resolved

cursor bot reviewed Feb 17, 2026

View reviewed changes

web_src/src/pages/workflowv2/mappers/grafana/query_data_source.ts Show resolved Hide resolved

cursor bot reviewed Feb 17, 2026

View reviewed changes

pkg/integrations/grafana/on_alert_firing.go Show resolved Hide resolved

AleksandarCole assigned forestileao Feb 17, 2026

AleksandarCole added pr:stage-3/3 Ready for full, in-depth, review and removed pr:stage-2/3 Needs to pass functional review labels Feb 17, 2026

forestileao reviewed Feb 17, 2026

View reviewed changes

web_src/src/ui/componentSidebar/index.tsx Outdated Show resolved Hide resolved

forestileao reviewed Feb 17, 2026

View reviewed changes

web_src/src/pages/workflowv2/mappers/grafana/on_alert_firing.ts Outdated Show resolved Hide resolved

cursor bot reviewed Feb 18, 2026

View reviewed changes

pkg/integrations/grafana/grafana.go Show resolved Hide resolved

cursor bot reviewed Feb 18, 2026

View reviewed changes

pkg/integrations/grafana/on_alert_firing.go Show resolved Hide resolved

cursor bot reviewed Feb 18, 2026

View reviewed changes

pkg/integrations/grafana/on_alert_firing.go Show resolved Hide resolved

pkg/server/server.go Outdated Show resolved Hide resolved

cursor bot reviewed Feb 18, 2026

View reviewed changes

pkg/integrations/grafana/webhook_handler.go Outdated Show resolved Hide resolved

mfuzailzubari and others added 28 commits February 19, 2026 16:22

fix(grafana): run gofmt on client and query data source

cc4ad0c

Signed-off-by: Muhammad Fuzail Zubari <mfuzail.zubari@gmail.com>

fix(grafana): harden contact-point parsing and sync generated compon…

37825a5

…ent docs (superplanehq#1945) Signed-off-by: Muhammad Fuzail Zubari <mfuzail.zubari@gmail.com>

fix(grafana): use per-trigger webhook binding and keep contact points…

cfb6cef

… UI-editable (superplanehq#1945) Signed-off-by: Muhammad Fuzail Zubari <mfuzail.zubari@gmail.com>

refactor(grafana-ui): deduplicate mapper helpers into shared utils (s…

f021d7f

…uperplanehq#1945) Signed-off-by: Muhammad Fuzail Zubari <mfuzail.zubari@gmail.com>

fix(grafana): use integration-resource datasource field and implement…

e01fde7

… datasource listing (superplanehq#1945) Signed-off-by: Muhammad Fuzail Zubari <mfuzail.zubari@gmail.com>

docs(grafana): update setup instructions for service accounts (with l…

0f188e7

…egacy API key fallback) (superplanehq#1945) Signed-off-by: Muhammad Fuzail Zubari <mfuzail.zubari@gmail.com>

fix(grafana-ui): enhance alert setup message box and add webhook URL…

6b78f12

… copy button (superplanehq#1945) Signed-off-by: Muhammad Fuzail Zubari <mfuzail.zubari@gmail.com>

docs fix + linting (superplanehq#1945)

26f98b1

Signed-off-by: Muhammad Fuzail Zubari <mfuzail.zubari@gmail.com>

fix(grafana): make webhook cleanup no-op without contact point and ga…

2226afe

…te firing trigger on top-level status (superplanehq#1945) Signed-off-by: Muhammad Fuzail Zubari <mfuzail.zubari@gmail.com>

fix(grafana): validate webhook context before requesting webhook in …

d9d7faf

…onAlertFiring setup Signed-off-by: Muhammad Fuzail Zubari <mfuzail.zubari@gmail.com>

fix(grafana): make webhook cleanup no-op when metadata is nil (superp…

421a54a

…lanehq#1945) Signed-off-by: Muhammad Fuzail Zubari <mfuzail.zubari@gmail.com>

fix(grafana-ui): use shared user-timezone timestamp formatter (superp…

7ca90f2

…lanehq#1945) Signed-off-by: Muhammad Fuzail Zubari <mfuzail.zubari@gmail.com>

feat: Connection retries for SSH component (superplanehq#3112)

140444d

Signed-off-by: Igor Šarčević <igor@operately.com> Signed-off-by: Muhammad Fuzail Zubari <mfuzail.zubari@gmail.com>

feat: Hetzner integration with createServer and deleteServer (superpl…

05daf47

…anehq#3116) Signed-off-by: Igor Šarčević <igor@operately.com> Signed-off-by: Muhammad Fuzail Zubari <mfuzail.zubari@gmail.com>

chore: Fix generated integration filenames (superplanehq#3128)

cdae3a9

Signed-off-by: Igor Šarčević <igor@operately.com> Signed-off-by: Muhammad Fuzail Zubari <mfuzail.zubari@gmail.com>

feat: AWS ECS integration + 3 components (superplanehq#3118)

2385557

Signed-off-by: Muhammad Fuzail Zubari <mfuzail.zubari@gmail.com>

refactor(grafana): unify validation and harden mapper timestamp/detai…

dc01963

…ls consistency (superplanehq#1945) Signed-off-by: Muhammad Fuzail Zubari <mfuzail.zubari@gmail.com>

fix(grafana): retry transient webhook provisioning failures and mask …

9129617

…shared secret input (superplanehq#1945) Signed-off-by: Muhammad Fuzail Zubari <mfuzail.zubari@gmail.com>

formatting fixed. (superplanehq#1945)

ecf3fbc

Signed-off-by: Muhammad Fuzail Zubari <mfuzail.zubari@gmail.com>

fix(grafana): use per-trigger webhook binding and keep contact points…

bd81ac1

… UI-editable (superplanehq#1945) Signed-off-by: Muhammad Fuzail Zubari <mfuzail.zubari@gmail.com>

refactor(grafana-ui): deduplicate mapper helpers into shared utils (s…

e9e4264

…uperplanehq#1945) Signed-off-by: Muhammad Fuzail Zubari <mfuzail.zubari@gmail.com>

docs(grafana): update setup instructions for service accounts (with l…

6df39dd

…egacy API key fallback) (superplanehq#1945) Signed-off-by: Muhammad Fuzail Zubari <mfuzail.zubari@gmail.com>

docs fix + linting (superplanehq#1945)

f7a4c8c

Signed-off-by: Muhammad Fuzail Zubari <mfuzail.zubari@gmail.com>

mfuzailzubari force-pushed the feat/grafana-integration branch from db83eab to f7a4c8c Compare February 19, 2026 11:24

cursor bot reviewed Feb 19, 2026

View reviewed changes

		@@ -0,0 +1,2 @@
		ALTER TABLE app_installations
		ALTER COLUMN state_description TYPE character varying(1024);

Conversation

mfuzailzubari commented Feb 11, 2026

Uh oh!

Uh oh!

Uh oh!

AleksandarCole commented Feb 12, 2026

Uh oh!

Uh oh!

Uh oh!

mfuzailzubari commented Feb 13, 2026

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

mfuzailzubari commented Feb 13, 2026

Uh oh!

AleksandarCole commented Feb 16, 2026

Uh oh!

Uh oh!

Uh oh!

mfuzailzubari commented Feb 17, 2026

Uh oh!

AleksandarCole commented Feb 17, 2026

Uh oh!

Uh oh!

Uh oh!

forestileao commented Feb 17, 2026

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

cursor bot left a comment

Choose a reason for hiding this comment

Uh oh!

cursor bot Feb 19, 2026

Choose a reason for hiding this comment

New migrations missing down migration files

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

17 participants

Comments